Table Sound
Functions for sound management.
Functions
| PlayAudioTrack(filename, type) | Play an audio track. |
| SetAmbientTrack(name, fromStart) | Set and play an ambient track. |
| StopAudioTracks() | Stop any audio tracks currently playing. |
| StopAudioTrack(type) | Stop audio track that is currently playing. |
| GetAudioTrackLoudness(type) | Get current loudness level for specified track type. |
| PlaySound(soundID[, position]) | Play sound effect. |
| StopSound(soundID) | Stop sound effect. |
| IsSoundPlaying(soundID) | Check if the sound effect is playing. |
| IsAudioTrackPlaying(Track) | Check if the audio track is playing. |
| GetCurrentSubtitle() | Get current subtitle string for a voice track currently playing. |
Functions
- PlayAudioTrack(filename, type)
-
Play an audio track. Supported formats are wav, mp3 and ogg.
Parameters:
- filename string Filename of a track (without file extension) to play.
- type SoundTrackType Type of the audio track to play.
- SetAmbientTrack(name, fromStart)
-
Set and play an ambient track.
Parameters:
- name string Name of track (without file extension) to play.
- fromStart bool Specifies whether ambient track should play from the start, or crossfade at a random position.
- StopAudioTracks()
- Stop any audio tracks currently playing.
- StopAudioTrack(type)
-
Stop audio track that is currently playing.
Parameters:
- type SoundTrackType Type of the audio track.
- GetAudioTrackLoudness(type)
-
Get current loudness level for specified track type.
Parameters:
- type SoundTrackType Type of the audio track.
Returns:
-
float
Current loudness of a specified audio track.
- PlaySound(soundID[, position])
-
Play sound effect.
Parameters:
- soundID int Sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window.
- position Vec3 The 3D position of the sound, i.e. where the sound "comes from". If not given, the sound will not be positional. (optional)
- StopSound(soundID)
-
Stop sound effect.
Parameters:
- soundID int Sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window.
- IsSoundPlaying(soundID)
-
Check if the sound effect is playing.
Parameters:
- soundID int Sound ID to check. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window.
- IsAudioTrackPlaying(Track)
-
Check if the audio track is playing.
Parameters:
- Track string Filename to check. Should be without extension and without full directory path.
- GetCurrentSubtitle()
-
Get current subtitle string for a voice track currently playing.
Subtitle file must be in .srt format, have same filename as voice track, and be placed in same directory as voice track.
Returns nil if no voice track is playing or no subtitle present.
Returns:
-
string
Current subtitle string.